Summary

• Add --follow (-f) flag to npx atxp paas worker logs command for continuous log streaming
• Implement client-side polling using the existing since parameter
• Add --interval flag to customize polling interval (default: 2000ms)

Features

• Stream logs continuously with Ctrl+C to stop
• Color-coded log output by level (error=red, warn=yellow, info=blue, debug=gray)
• Deduplication to prevent duplicate log entries
• Automatic retry logic (3 attempts with 5s delay on failure)
• Memory-bounded deduplication set (max 10k entries)
• Works with existing filters (--level, --since)

Test plan

• Deploy a test worker that generates periodic logs
• Run npx atxp paas worker logs <name> --follow
• Verify logs stream in real-time
• Verify Ctrl+C stops gracefully with "Stopping log stream..." message
• Test --level filter works in follow mode
• Verify no duplicate logs appear
• Test custom interval with --interval 500
• Verify CI passes

Usage

# Stream logs continuously
npx atxp paas worker logs my-api --follow

# With custom interval (500ms)
npx atxp paas worker logs my-api -f --interval 500

# Combined with filters
npx atxp paas worker logs my-api --follow --level error

Closes ATXP-1431

🤖 Generated with Claude Code